home *** CD-ROM | disk | FTP | other *** search
/ SGI Performance Co-Pilot 1.3 / SGI Performance Co-Pilot 1.3.iso / dist / dist6.4 / pcp.idb / usr / share / catman / u_man / cat3 / PMAPI / _pmctime.z / _pmctime
Text File  |  1997-04-03  |  3KB  |  67 lines
  1.  
  2.  
  3.  
  4. ____PPPPMMMMCCCCTTTTIIIIMMMMEEEE((((3333))))                                                        ____PPPPMMMMCCCCTTTTIIIIMMMMEEEE((((3333))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      ____ppppmmmmCCCCttttiiiimmmmeeee - format the date and time for a reporting timezone
  10.  
  11. CCCC SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      ####iiiinnnncccclllluuuuddddeeee <<<<ttttiiiimmmmeeee....hhhh>>>>
  13.      ####iiiinnnncccclllluuuuddddeeee <<<<ppppccccpppp////iiiimmmmppppllll....hhhh>>>>
  14.  
  15.      cccchhhhaaaarrrr ****____ppppmmmmCCCCttttiiiimmmmeeee((((ccccoooonnnnsssstttt ttttiiiimmmmeeee____tttt ****cccclllloooocccckkkk,,,, cccchhhhaaaarrrr ****bbbbuuuuffff))))
  16.  
  17.      cccccccc ............ ----llllppppccccpppp
  18.  
  19. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  20.      ____ppppmmmmCCCCttttiiiimmmmeeee is very similar to ccccttttiiiimmmmeeee(3), except the timezone used is the
  21.      current ``reporting timezone'' (rather than the default TTTTZZZZ environment
  22.      variable scheme), and the result is returned into a caller-declared
  23.      buffer (rather than a private buffer).
  24.  
  25.      Like ccccttttiiiimmmmeeee(3) the time to be converted is passed via _c_l_o_c_k, and the
  26.      result in _b_u_f is fixed width fields in the format:
  27.  
  28.                Fri Sep 13 00:00:00 1986\n\0
  29.  
  30.      The result buffer _b_u_f must be at least 26 bytes long, and no attempt is
  31.      made to check this.  ____ppppmmmmCCCCttttiiiimmmmeeee returns _b_u_f as the value of the function.
  32.  
  33.      The default current reporting timezone is as defined by the TTTTZZZZ
  34.      environment variable, so ____ppppmmmmCCCCttttiiiimmmmeeee and ccccttttiiiimmmmeeee(3) will initially produce
  35.      similar encoding of the date and time.
  36.  
  37.      Use ____ppppmmmmNNNNeeeewwwwZZZZoooonnnneeee(3), ____ppppmmmmNNNNeeeewwwwCCCCoooonnnntttteeeexxxxttttZZZZoooonnnneeee(3) or ____ppppmmmmUUUUsssseeeeZZZZoooonnnneeee(3) to establish a
  38.      new current reporting timezone that will effect ____ppppmmmmCCCCttttiiiimmmmeeee but not
  39.      ccccttttiiiimmmmeeee(3).
  40.  
  41. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  42.      ccccttttiiiimmmmeeee(3), PPPPMMMMAAAAPPPPIIII(3), ____ppppmmmmLLLLooooccccaaaallllttttiiiimmmmeeee(3), ____ppppmmmmMMMMkkkkttttiiiimmmmeeee(3), ____ppppmmmmNNNNeeeewwwwCCCCoooonnnntttteeeexxxxttttZZZZoooonnnneeee(3),
  43.      ____ppppmmmmNNNNeeeewwwwZZZZoooonnnneeee(3) and ____ppppmmmmUUUUsssseeeeZZZZoooonnnneeee(3).
  44.  
  45. DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.                                                                         PPPPaaaaggggeeee 1111
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.